Thank you for taking the trouble to try this program out. We hope you like it.
Note: this file is formatted and is best read with SimpleText and not TeachText.
Note: this file is not read-only so that you can easily copy the text if you want to. For example, you can copy the email addresses and URLs. Please don’t modify this file or distribute modified versions.
Note: you should scroll up and down a pageful at a time so that the pictures will appear properly. If the pictures don’t appear, you can make them appear by scrolling up a page and then back down a page.
This software is copyrighted material and therefore you are not allowed to modify this software or its documentation in any way, shape or form, nor can you sell it for your own profit. You may only charge a reasonable fee for the cost of distributing it. See the Distribution section below for information about how and on what IIe may be distributed.
Contents
The documentation for IIe comes in 4 files. Their contents are:
1. Read me first
What is it? - description, features, requirements, compatibilty, and performance issues
Description
Features
Hardware and software requirements
Compatibility
Performance issues
Installation and setup
Simple installation/setup
Tips
Frequently Asked Questions (FAQ)
2. Instructions
The Apple //e window
The display area
The //e screen - screen snapshots
The icon buttons
Function keys
Graphics modes
Disk inserting/removing
Using real disks
Using disk images
How to insert and remove disks and disk images
Loading and saving information - memory images
Emulator instructions
Default settings
Starting up the emulator
The Reset key
The Keyboard
Paddles and buttons
Debugger instructions
3. Configuring IIe
General pane
65c02 pane
Memory pane
Video pane
Sound pane
Keyboard pane
Joystick/Mouse pane
Printing pane
5 1/4" Disks pane
Other Disks pane
Slots pane
4. Other stuff
Cost/fee and registration
Version history
Future version features
Distribution
Contacting the author
Other software by Vincent
Disclaimer
Cost/fee and registration
IIe 3.0.1 is released as shareware. That is, you can freely copy and distribute this version as you see fit, but you may not modify it nor may you charge more than a reasonable fee for distributing it. If you decide to keep it, you are then obliged to send in the registration form and the fee of US$30. On doing so, you will be sent a registration letter (preferably by email since it is faster and cheaper than normal mail) which will tell you how to register your copy of IIe. You may not distribute the registration letter or registered versions.
If you have registered a previous version (2.0 to 2.0.3) then you upgrade to v3.x for the small fee of US$5.
OK, so how do I register/upgrade?
1) Start up IIe. When the main window is visible, go to the Register menu and select “Fill in registration form…”.
2) Follow the dialog prompts and enter the required information.
3) If you wish to upgrade from a previously registered version, be sure to change the “I wish to register” menu to “I wish to upgrade”.
4) Save or print the form and send it and the fee (or the necessary information) to the shown email address or normal mail address. If you send email, you should receive a reply within a few days to a week (depending on the backlog). If you send normal mail, it may take a few weeks to process the form. Please be patient. If at all possible, please include an email address. You will get a much faster reply by doing so.
Version history
1.0 — Released Dec 21, 1995. First release. Project commenced Oct 23, 1995. All code except support for the internal floppy disk written by Vince. Support for the internal floppy disk written by my brother Victor - you know, the guy that wrote SpeedyFinder7 and co-authored CyberFinder!
2.0 — Released Mar 2, 1996. Major rewriting to add speed and features. Vince wrote: the PowerPC CPU, memory, floppy disk, UniDisk, user interface (dialogs and icons), preferences, about box, registration code, and these documents. Vic wrote: the 68K CPU, the graphics blitters, the sound code, the Memory card, the Mouse card, the Clock card, the Mac-ProDOS card, support for real floppy disks and SCSI hard disk partitions, and the 6502 debugger window. Whew.
2.0.1 — Released Mar 3, 1996. Fixed a bug causing crashes on 68K Macs when opening the preferences.
2.0.2 - 2.0.3 — Released May 1996. Fixed a problem with 5 1/4" nibble disk images and booting 3 1/2" disks.
3.0 — Released June 30, 1996. Major update to add features and fix bugs. Vince wrote: the printer card, user interface (now supports drag and drop), preferences, support for more drives (Mac-ProDOS and UniDisk), and these documents. Vic wrote: the PowerPC CPU (now in full assembly) and the sharp graphics blitters (again, in assembly). Many bugs with the disk images, the clock card, the mouse card, and the memory card were fixed.
3.0.1 — Released August 6, 1996. Mostly a bug fix release with a few new features. Now supports keyboard input from the keypad when the joystick is the mouse and not the keypad; can now save the //e screen to a PICT file (the Dump command in the File menu); fixed problems with some programs like Wings of Fury; no longer crashes when printing with some programs.
Future version features
This is the list of possible features to be added in a future version:
? better video modes (small colour double hires)
? mockingboard support (coming soon I hope now that I've got one of the beasts)
? further serial card support (printing fonts, printing graphics)
? ability to save the memory card’s contents as a separate file/hard disk image
? display useful info such as track/sector being read or written
If you have an idea for a feature you’d like to see, why not write and let me know about it? I know there are plenty of Apple II enthusiasts still around so why not help me make this a better program? I’m sure we’ll both enjoy the results. :-)
Distribution
Disks and CD-ROMs
The unregistered version of IIe 3.0 and only the unregistered version may be distributed freely but it must be distributed in its entirety, that is, with this Read Me, and neither the program nor this Read Me may be modified in any way, shape or form. It can be put on disks and CD-ROMs. I (Vincent) would appreciate a copy each of any such disks or CD-ROMs so that I know what it is being distributed on. Thank you.
I also ask that you contact me about the latest version so that only that version is distributed.
WWW and other internet methods of distribution
The latest version is available at this internet World Wide Web location:
<http://www.usyd.edu.au/~vtan/index.html>
or
<http://www.kagi.com/authors/vincenttan/>
If you wish to add a link on your WWW page to this page you are most welcome to do so. On the other hand, if you want put the actual binhex on your WWW or ftp or gopher (or whatever) site for others to download then you can do so provided that only an unmodified copy of the binhex on the above site is used. You may not offer a decoded version nor may you decode it, change something (or nothing) and then recompress and rebinhex it - in other words: you may only offer the exact same file that is on this site.
Contacting the author
Please, if you have a problem with this program, read these documents first to see if the answer is already here! This will save both you and me a lot of time and trouble. Thank you for your help on this matter.
Otherwise, if you have comments, gripes, if you found something missing or something not clearly explained, or whatever... write to me and let me know your thoughts about this software. I’m always happy to answer your enquiry and improve this software.
To write via e-mail, send it to either of these (internet) addresses:
<mailto:vtan@extro.ucc.su.oz.au>
<mailto:VincentTan@kagi.com> - the mailer daemon here will re-route it the first address
Please put “Apple IIe” or “IIe” in the Subject line so we know what it's about. Thank you.
Other software by Vincent
• Jigsaw 2.1. It’s a cool shareware program that lets you play jigsaw puzzles on your Mac and has many options and features to keep you engrossed for hours. It’s certainly better than the one you get with System 7.5 - “You call that a puzzle?” :-) It’s currently available in English, Dutch, French and German versions. (If you want to translate it, I can give you a registration for your efforts.) The latest version is 2.1•. A starter picture is included. Jigsaw can open PICTs, JPEGs, GIFs, and several other formats.
• Control Strip Menu 2.3.2. Make your Control Strip give you easy access to any file on your disk by popup menus of your favourite folders (similar to the many Apple Menu extensions currently available). Features: supports drag and drop; has “sticky menus” feature to make navigating folders easy; draws cool icons. Very handy to have. Shareware. Also available in German and Italian.
• AddGIFcomment 1.0.1. Allows you to add a comment to a GIF picture file. Freeware.
• AddJFIFcomment 1.0.2. Allows you to add a comment to a JPEG/JFIF picture file. Freeware.
• ResComparePatcher 1.0. Source code that allows you to create a ResCompare patcher that can patch fat [68k & PowerPC] applications. Freeware.
On the internet, you can obtain the latest versions of these titles by using an ftp client to get them from:
or better yet, use a mirror site such as <ftp://mirrors.aol.com/>
You can also get them by visiting this World Wide Web site:
<http://www.usyd.edu.au/~vtan/index.html>
or
<http://www.kagi.com/authors/vincenttan/>
The first WWW URL also has software by Vic on it, as well as useful links.
Disclaimer
I hate these. Anyway, it’s the usual stuff:
Use at your own risk. The author accepts no liability for any damage caused. All other copyrights are held by their respective owners. Etc, etc, etc.
’Told you I hate them.
Aren’t you glad I don’t bore you with a License Agreement? :-)
Have fun,
Vincent.
August 6, 1996.
PS: if you really want to know why I wrote this, it’s because I got envious of the fact that other platforms had //e emulators and the Mac didn’t. I thought it was sad that the company that made and sold Apple II’s no longer had any way of running Apple II software except by the IIe card for Mac LC’s perhaps - and who can find one of those beasts nowadays?
PPS: why did Vic help? Because he loved working on it. There’s just no doubt about it: Apple IIs are a lot of fun! ;-)
PPPS: many thanks to all those who have written with problems and suggestions and thanks. It’s all appreciated greatly.
